home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Discovery Series: Yosemite / Multimedia Discovery Series: Yosemite.iso / pc / alchemy / addendum.doc next >
Encoding:
Text File  |  1992-05-19  |  67.5 KB  |  2,435 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                     Image Alchemy
  15.  
  16.  
  17.  
  18.  
  19.                                      Version 1.6
  20.  
  21.  
  22.  
  23.  
  24.                                       Addendum
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                                Handmade Software, Inc.
  57.  
  58.  
  59.  
  60.  
  61.           Trademarks       Image Alchemy is a trademark of Handmade
  62.                            Software, Inc.
  63.  
  64.                            All other products or services mentioned in this
  65.                            manual are trademarks, registered trademarks,
  66.                            service marks, or registered service marks of
  67.                            their respective companies or organizations.
  68.  
  69.                            Even though they are never mentioned in this
  70.                            document, you should know that Yellow Pages is a
  71.                            registered trademark in the United Kingdom of
  72.                            British Telecommunications plc., and may also be
  73.                            a trademark of various telephone companies
  74.                            around the world.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.                            Copyright (c) 1990-1992 Handmade Software, Inc.
  83.  
  84.                            All Rights Reserved
  85.  
  86.  
  87.  
  88.                            First Printing
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.                            Handmade Software, Inc.
  99.                            15951 Los Gatos Blvd., Suite 17
  100.                            Los Gatos, CA  95032
  101.                            +1 408 358-1292
  102.                            +1 408 358-2694 fax
  103.                            +1 408 356-3297 BBS
  104.  
  105.                            Internet:  hsi@netcom.COM
  106.                            CompuServe:  71330, 3136
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-ii
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           Contents
  124.           -----------------------------------------------------------------
  125.  
  126.  
  127.  
  128.  
  129.           Introduction.......................... 1
  130.  
  131.           Image Alchemy for MS-DOS.............. 2
  132.  
  133.           File Formats.......................... 4
  134.              Alpha Microsystems BMP............. 5
  135.              AVHRR.............................. 6
  136.              CALS............................... 8
  137.              Cubicomp PictureMaker.............. 9
  138.              Dr. Halo CUT...................... 10
  139.              First Publisher ART............... 11
  140.              GEM VDI Image File................ 12
  141.              GOES.............................. 14
  142.              IBM Picture Maker................. 16
  143.              PDS............................... 17
  144.              RIX............................... 18
  145.              SGI............................... 19
  146.              SPOT Image........................ 20
  147.              Sun Raster........................ 21
  148.              Windows Bitmap.................... 22
  149.              XPM............................... 25
  150.  
  151.           Colour and Palette Options........... 26
  152.              Dither............................ 27
  153.              Gamma correction.................. 29
  154.              Negate............................ 31
  155.              Spiff............................. 32
  156.  
  157.           Viewing Options (MS-DOS Only)........ 34
  158.              View Image in 15 Bit Mode......... 35
  159.              View Scaled Image in 15 Bit Mode.. 36
  160.  
  161.           Answers to Frequently Asked Questions 37
  162.  
  163.           Version History...................... 38
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-iii
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.           Introduction to this Addendum
  185.           -----------------------------------------------------------------
  186.  
  187.  
  188.           Why an Addendum? This addendum covers changes in Image Alchemy
  189.                            that were made after the manual was printed.
  190.                            These changes consist of new file formats,
  191.                            changes to existing file formats, additions and
  192.                            changes in colouring options, and changes in the
  193.                            viewing options (for the MS-DOS version only).
  194.  
  195.                            Where changes have been made, this manual covers
  196.                            the options in their entirety, saving you the
  197.                            trouble of having to look at both manuals for a
  198.                            single option.
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-1
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.           Image Alchemy for MS-DOS
  241.           -----------------------------------------------------------------
  242.  
  243.  
  244.           Use of extended  If there is enough extended or expanded memory
  245.           and expanded     available, Alchemy will use it instead of the
  246.           memory           temporary file it would otherwise use during
  247.                            some conversions.  To use extended memory you
  248.                            must have an XMS driver installed in the
  249.                            config.sys file (such as HIMEM.SYS or 386MAX).
  250.                            To use expanded memory you must have a LIM 3.2
  251.                            or LIM 4.0 expanded memory driver installed
  252.                            (such as EMM386, QEMM, or 386MAX).
  253.  
  254.                            It is possible for there to be some
  255.                            incompatibility when using some older drivers
  256.                            and/or TSRs which also use extended memory.
  257.                            Therefore Alchemy's use of extended/expanded
  258.                            memory can be disabled.  To disable use of
  259.                            extended and expanded memory, set an environment
  260.                            variable called 'alchemy' to 'x' (type "set
  261.                            alchemy=x" at the DOS prompt).
  262.  
  263.                            Note that the availability of extended or
  264.                            expanded memory will not allow you to convert
  265.                            larger images, just speed up conversions.  We
  266.                            also have a 386 version of Image Alchemy, which
  267.                            will allow 80386 and 80486 users to make use of
  268.                            the linear addressing space of those processors
  269.                            along with virtual memory to convert images of
  270.                            up to 32000 x 32000 (assuming you have enough
  271.                            disk space).  Please contact us if you are
  272.                            running out of memory and are interested in
  273.                            upgrading to Alchemy/386.
  274.  
  275.           Checking for     Alchemy will normally check to determine if
  276.           8514/A boards    there is an 8514/A board installed in the
  277.                            computer when viewing images.  However, this can
  278.                            cause problems with some network boards, as they
  279.                            use the same I/O addresses that 8514/A boards
  280.                            use.  To disable 8514/A checking, set the
  281.                            environment variable called 'alchemy' to '8'
  282.                            (type "set alchemy=8" at the DOS prompt).
  283.  
  284.                            Note that this can be combined with other
  285.                            options; for example, to disable both 8514/A
  286.                            checking and extended/expanded memory usage, use
  287.                            "set alchemy=8x".
  288.  
  289.  
  290.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-2
  291.  
  292.  
  293.  
  294.           Limiting maximum Alchemy will automatically choose the lowest
  295.           display          resolution which will fit the entire image when
  296.           resolution       viewing images without specifying a display
  297.                            resolution with a VESA compatible VGA board.
  298.                            However, depending on the monitor and VGA board
  299.                            combination you have, this can be bad since the
  300.                            monitor may not support all the resolutions the
  301.                            SVGA board does.  Therefore the environment
  302.                            variable 'alchemy' may now be set to indicate
  303.                            the maximum display resolution which Alchemy
  304.                            should use.  Set the alchemy variable to the
  305.                            highest horizontal resolution which your monitor
  306.                            is capable of.  Valid values are 1280, 1024,
  307.                            800, and 640.  For example, "set alchemy=800",
  308.                            if your monitor only supports 640x480 and
  309.                            800x600 mode.
  310.  
  311.                            Note that this can be combined with other
  312.                            options; for example, to disable 8514/A
  313.                            checking, disable extended/expanded memory
  314.                            usage, and limit the viewing resolution to
  315.                            640x480 use "set alchemy=8x640".
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-3
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.           Output Options
  357.           -----------------------------------------------------------------
  358.  
  359.  
  360.           Introduction     Since the release of v1.5 several new output
  361.                            formats have been added and several existing
  362.                            output formats have had compression modes or
  363.                            output options added.
  364.  
  365.                            Formats which have had options added:
  366.                               GEM VDI        Sun Raster
  367.                               SGI            Windows BMP
  368.  
  369.                            New formats:
  370.                               Alpha Microsystems BMP
  371.                               AVHRR
  372.                               CALS
  373.                               Cubicomp PictureMaker
  374.                               Dr. Halo CUT
  375.                               First Publisher ART
  376.                               GOES
  377.                               IBM Picture Maker
  378.                               PDS
  379.                               RIX
  380.                               SPOT Image
  381.                               XPM
  382.  
  383.                            In addition to those changes, the following
  384.                            formats are now optimally compressed when they
  385.                            are written by Image Alchemy; this can result in
  386.                            a significant savings in disk space for certain
  387.                            images:
  388.                               WPG
  389.                               Utah Raster Toolkit (RLE)
  390.                               GEM IMG
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-4
  407.  
  408.  
  409.  
  410.           Alpha Microsystems BMP                                         -M
  411.  
  412.  
  413.                            Alpha Microsystems BMP files are used by Alpha
  414.                            Microsystems.
  415.  
  416.           Syntax           -M compressionType
  417.  
  418.           Parameter        compressionType:
  419.                                 0:None
  420.                                 1:Packed
  421.                            The default is None.
  422.  
  423.           Extension        .bmp
  424.  
  425.           Creator          Alpha Microsystems.
  426.  
  427.           Used by          Alpha Microsystems workstations.
  428.  
  429.           Variations       Reads and writes 1, 4, 8, and 24 bit unpacked
  430.                            and packed (run-length encoded) RGB images.
  431.  
  432.           Limitations      Reading and writing HLS images is not supported.
  433.  
  434.           Comments         When reading an image without a palette Alchemy
  435.                            will generate a gray-scale palette.
  436.  
  437.           Examples         Convert the GIF file, bigpict.gif, to an
  438.                            uncompressed Alpha Microsystems BMP file:
  439.  
  440.                                 alchemy bigpict.gif -M
  441.  
  442.                            Do the same thing, but force a 24 bit image, and
  443.                            compress the image:
  444.  
  445.                                 alchemy bigpict.gif -M1 -24
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-5
  465.  
  466.  
  467.  
  468.           AVHRR                                                         --R
  469.  
  470.  
  471.                            AVHRR files are used for satellite image data.
  472.  
  473.           Syntax           --R outputType
  474.  
  475.           Parameter        outputType
  476.                                 1:IDIDAS Uncompressed
  477.                                 2:IDIDAS Compressed type 1
  478.                            The default is 1 (IDIDAS Uncompressed).
  479.  
  480.           Extension        .sst
  481.  
  482.           Creator          National Oceanic and Atmospheric Administration
  483.                            (NOAA)
  484.                            National Environmental Satellite Data
  485.                            Information Service (NESDIS)
  486.  
  487.           Used by          IDIDAS
  488.                            SSTMAP
  489.                            IMGMAP
  490.  
  491.           Variations       Reads 8 and 11 bits per pixel IDIDAS AVHRR
  492.                            files.
  493.  
  494.                            Writes 11 bits per pixel IDIDAS AVHRR files.
  495.  
  496.           Limitations      Level 1B AVHRR files will be supported at a
  497.                            later date; please contact us for more
  498.                            information.
  499.  
  500.                            Alchemy discards all but the top 8 bits when
  501.                            reading 11 bit AVHRR files.  When writing, the
  502.                            bottom 3 bits are padded with 0.
  503.  
  504.                            Any graphics information is discarded when
  505.                            reading the file.
  506.  
  507.                            Since AVHRR images are always grayscale, Alchemy
  508.                            assumes the use of the -b and -8 options when
  509.                            writing a AVHRR file.
  510.  
  511.           Comments         AVHRR images contain a lot of information which
  512.                            is not part of the image data.  This information
  513.                            includes the time and date the image was
  514.                            captured, the satellite which captured the
  515.                            image, the type of instrumentation used, etc.
  516.                            When reading AVHRR images this information is
  517.                            discarded; when writing AVHRR images 0 is
  518.                            written for all values for which data is
  519.                            unavailable.
  520.  
  521.  
  522.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-6
  523.  
  524.  
  525.  
  526.           Examples         Convert the GOES file, florida.goe, to an
  527.                            uncompressed IDIDAS AVHRR file:
  528.  
  529.                                 alchemy --R1 florida.goe
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-7
  581.  
  582.  
  583.  
  584.           CALS                                                          --c
  585.  
  586.  
  587.                            Computer-aided Acquisition and Logistics Support
  588.                            (CALS) files are black and white images used by
  589.                            the US Government as part of their transition to
  590.                            electronic media.
  591.  
  592.           Syntax           --c
  593.  
  594.           Extension        .cal
  595.  
  596.           Creator          Defense Logistics Agency (DLA)
  597.  
  598.           Used by          Department of Defense (DoD)
  599.  
  600.           Variations       Reads and writes type 1 (Group 4 raster) CALS
  601.                            images.
  602.  
  603.           Limitations      Document labels, such as document ID and figure
  604.                            ID, are ignored.
  605.  
  606.           Comments         Since CALS files are always black and white,
  607.                            Alchemy assumes the use of the -b, -8, and -c2
  608.                            options when writing CALS files.
  609.  
  610.                            CALS images are Fax Group IV compressed and are
  611.                            therefore a good way of storing black and white
  612.                            line drawings and scans.
  613.  
  614.           Examples         Convert the TIFF file page1.tif to a CALS file:
  615.  
  616.                                 alchemy page1.tif --c
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-8
  639.  
  640.  
  641.  
  642.           Cubicomp PictureMaker                                         --P
  643.  
  644.  
  645.                            Cubicomp PictureMaker files are used in
  646.                            broadcast-quality three dimensional modelling
  647.                            and animation.
  648.  
  649.           Syntax           --P
  650.  
  651.           Extension        .r8 (Red channel image data)
  652.                            .g8 (Green channel image data)
  653.                            .b8 (Blue channel image data)
  654.                            .a8 (Alpha channel image data [optional)
  655.  
  656.           Creator          Cubicomp Corp.
  657.  
  658.           Used by          Cubicomp PictureMaker
  659.  
  660.           Variations       Reads and writes 24 bit true colour images.
  661.  
  662.           Limitations      If an alpha channel exists, it will be ignored.
  663.  
  664.                            8-bit paletted PictureMaker files are
  665.                            unsupported.
  666.  
  667.           Comments         This format is not the same as IBM Picture
  668.                            Maker.
  669.  
  670.                            PictureMaker images have either three or four
  671.                            separate files per image: a red, green, blue,
  672.                            and optional alpha channel.  You specify the
  673.                            name of the .r8 file and Alchemy automatically
  674.                            generates the name of the .g8 and .b8 files
  675.  
  676.                            When writing a PictureMaker file Alchemy will
  677.                            overwrite, without warning, existing .g8 and .b8
  678.                            files.
  679.  
  680.           Examples         Convert the 24-bit JPEG image stones.jpg to
  681.                            PictureMaker files:
  682.  
  683.                                 alchemy --P stones.jpg
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-9
  697.  
  698.  
  699.  
  700.           Dr. Halo CUT                                                  --C
  701.  
  702.  
  703.                            Dr. Halo CUT files are used by various MS-DOS
  704.                            based paint software.
  705.  
  706.           Syntax           --C
  707.  
  708.           Extension        .pal (palette and header)
  709.                            .cut (pixel data)
  710.  
  711.           Creator          Media Cybernetics
  712.  
  713.           Used by          Dr. HALO III Paint Package
  714.                            HALO Desktop Imager
  715.  
  716.           Variations       8 bits per pixel
  717.  
  718.           Comments         Dr. Halo CUT images are actually two files.  You
  719.                            specify the name of the .cut file and Alchemy
  720.                            automatically generates the name of the .pal
  721.                            file.
  722.  
  723.                            When writing a Dr. Halo CUT file Alchemy will
  724.                            overwrite, without warning, existing .pal files.
  725.  
  726.           Examples         Convert the image test.pcx to a Dr. Halo CUT
  727.                            file:
  728.  
  729.                                 alchemy test.pcx --C
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-10
  755.  
  756.  
  757.  
  758.           First Publisher ART                                           --F
  759.  
  760.  
  761.                            First Publisher ART files are black and white
  762.                            images used as clip art by First Publisher.
  763.  
  764.           Syntax           --F
  765.  
  766.           Extension        .art
  767.  
  768.           Creator          Software Publishing Corp.
  769.  
  770.           Used by          First Publisher
  771.  
  772.           Variations       Black and white, 1 bit per pixel.
  773.  
  774.           Comments         Since ART files are always black and white, 1
  775.                            bit per pixel, Alchemy assumes use of the -c2
  776.                            and -b options when writing them.
  777.  
  778.           Examples         Convert the image scan.pcx to a First Publisher
  779.                            ART file:
  780.  
  781.                                 alchemy scan.pcx --F
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-11
  813.  
  814.  
  815.  
  816.           GEM VDI Image File                                            --g
  817.  
  818.  
  819.                            VDI files are files that were developed by
  820.                            Digital Research to use with GEM.
  821.  
  822.           Syntax           --g
  823.  
  824.           Extension        .img
  825.  
  826.           Creator          Digital Research Inc.
  827.  
  828.           Used by          GEM
  829.  
  830.           Variations       Reads 1-8 bit grayscale and 3 and 4 bit colour
  831.                            files.
  832.  
  833.                            Writes 1, 3, and 4 bit grayscale and 3 and 4 bit
  834.                            colour files.
  835.  
  836.           Limitations      The support for colour and multiple bit
  837.                            grayscale GEM files is not very universal.
  838.                            Therefore make sure the application you are
  839.                            using to read the GEM files can in fact handle
  840.                            them.
  841.  
  842.                            Alchemy defaults to writing out a 1 bit, black
  843.                            and white GEM file.  You can explicitly force a
  844.                            3 plane colour file by use of the -c8 option and
  845.                            a 4 plane colour file by use of the -c16 option
  846.                            (you may add a -b to write a grayscale file
  847.                            instead of a colour file).
  848.  
  849.           Comments         Because colour GEM files have only 3 or 4 bits
  850.                            of information and no palette support the
  851.                            quality is generally not very good for scanned
  852.                            images.  The GEM format seems to have been
  853.                            designed for line drawings.
  854.  
  855.  
  856.  
  857.           Examples         Convert the image scan.pcx to a black and white
  858.                            GEM file:
  859.  
  860.                                 alchemy scan.pcx --g
  861.  
  862.                            Convert the image bigscan.tga to a 640x480, 8
  863.                            colour GEM file, using nearest neighbor scaling
  864.                            and type 2 dithering:
  865.  
  866.                                 alchemy -c 8 --g bigscan.tga -X640
  867.                                   -Y480 -d2
  868.  
  869.  
  870.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-12
  871.  
  872.  
  873.  
  874.                            Do the same thing but write an 8 shade grayscale
  875.                            file with no dithering:
  876.  
  877.                                 alchemy -c 8 --g bigscan.tga -X640
  878.                                   -Y480 -d -b
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-13
  929.  
  930.  
  931.  
  932.           GOES                                                          --G
  933.  
  934.  
  935.                            GOES files are used for satellite image data.
  936.  
  937.           Syntax           --G goesType
  938.  
  939.           Parameter        goesType:
  940.                                 0:GARS format
  941.                                 1:McIDAS format
  942.                            The default is 0 (GARS format).
  943.  
  944.           Extension        .goe
  945.  
  946.           Creator          The University of Wisconsin
  947.                            National Oceanic and Atmospheric Administration
  948.                            (NOAA)
  949.                            National Environmental Satellite Data
  950.                            Information Service (NESDIS)
  951.  
  952.           Used by          Various satellite image processing software,
  953.                            including the McIDAS system.
  954.  
  955.           Variations       Reads 8, 16, and 32 bits per pixel GOES images.
  956.  
  957.                            Writes 8 bits per pixel images.
  958.  
  959.           Limitations      When reading 16 and 32 bit images Alchemy
  960.                            discards all but the top 8 bits of data.
  961.  
  962.                            Alchemy discards any calibration data and level
  963.                            maps when reading images.
  964.  
  965.                            Because of difficulty in getting a sufficient
  966.                            number of test images in the GOES format
  967.                            (especially the PUT format) reading GOES images
  968.                            has not been thoroughly tested.  If you have any
  969.                            GOES images  which Alchemy does not read
  970.                            correctly please contact us.
  971.  
  972.           Comments         The GARS format is a 7680 bytes per block,
  973.                            Motorola byte-order, EBCDIC format; the MCIDAS
  974.                            format is a continuous data, Intel byte-order,
  975.                            ASCII format.
  976.  
  977.                            Since GOES images are always grayscale, Alchemy
  978.                            assumes the use of the -b and -8 options when
  979.                            writing a GOES file.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-14
  987.  
  988.  
  989.  
  990.                            GOES images contain a lot of information which
  991.                            is not part of the image data.  This information
  992.                            includes the time and date the image was
  993.                            captured, the satellite which captured the
  994.                            image, the type of instrumentation used, etc.
  995.                            When reading a GOES image this information is
  996.                            discarded; when writing a GOES images 0 is
  997.                            written for all values for which data is
  998.                            unavailable.
  999.  
  1000.           Examples         Convert the Erdas file, florida.gis, into a GOES
  1001.                            GARS image:
  1002.  
  1003.                                 alchemy --G0 florida.gis
  1004.  
  1005.                            Do the same thing, but write out a GOES McIDAS
  1006.                            image:
  1007.  
  1008.                                 alchemy --G1 florida.gis
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-15
  1045.  
  1046.  
  1047.  
  1048.           IBM Picture Maker                                             --i
  1049.  
  1050.  
  1051.                            IBM Picture Maker files are used by IBM
  1052.                            presentation software.
  1053.  
  1054.           Syntax           --i
  1055.  
  1056.           Extension        .pic
  1057.  
  1058.           Creator          IBM
  1059.  
  1060.           Used by          IBM Storyboard Live!
  1061.  
  1062.           Variations       Reads and writes 256 colour Picture Maker files.
  1063.  
  1064.           Limitations      16 colour Picture Maker files are not supported.
  1065.                            Picture Maker images can not be larger than
  1066.                            640x480.
  1067.  
  1068.           Comments         This is not the same format as Cubicomp
  1069.                            PictureMaker.
  1070.  
  1071.                            256 colour Picture Maker files may be either
  1072.                            320x200 or 640x480.  Image Alchemy will write
  1073.                            the smallest variation that the image will fit
  1074.                            in, with the image centered; the borders will be
  1075.                            filled with colour 0.
  1076.  
  1077.           Examples         Convert the PCX file, giraffe.pcx, into an IBM
  1078.                            Picture Maker file:
  1079.  
  1080.                                 alchemy --i giraffe.pcx
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-16
  1103.  
  1104.  
  1105.  
  1106.           PDS                                                           --p
  1107.  
  1108.  
  1109.                            PDS labeled images are used by NASA for
  1110.                            planetary images.
  1111.  
  1112.           Syntax           --p
  1113.  
  1114.           Extensions       .ibg
  1115.                            .imq
  1116.  
  1117.           Creator          NASA
  1118.  
  1119.           Used by          NASA distributes collections of planetary images
  1120.                            on CD-ROM in PDS format.
  1121.  
  1122.           Variations       Reads 1 and 8 bit uncompressed and 8 bit first
  1123.                            difference Huffman compressed files.
  1124.  
  1125.                            Writes 8 bit gray-scale uncompressed PDS files.
  1126.  
  1127.           Limitations      PDS images must begin with either an
  1128.                            "SFDU_LABEL" or a "FILE_TYPE" record for Alchemy
  1129.                            to be able to identify it.
  1130.  
  1131.                            Occasionally a PDS labeled image has a palette.
  1132.                            There doesn't seem to be any standard format for
  1133.                            the palette; Image Alchemy handles the palettes
  1134.                            we've encountered.
  1135.  
  1136.                            Any portions of the PDS labels not required to
  1137.                            extract the image, such as longitude and
  1138.                            latitude, are ignored.
  1139.  
  1140.           Comments         Since Image Alchemy only writes gray-scale PDS
  1141.                            images, Alchemy assumes the use of the -b option
  1142.                            when writing PDS files.
  1143.  
  1144.                            Some PDS images actually consist of two files, a
  1145.                            label file and a data file.  To read that type
  1146.                            image you should use the name of the label file
  1147.                            and Alchemy will find the data file.
  1148.  
  1149.           Examples         Convert the GOES file, phoenix.goe, into a PDS
  1150.                            labeled image:
  1151.  
  1152.                                 alchemy --p phoenix.goe
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-17
  1161.  
  1162.  
  1163.  
  1164.           RIX                                                            -R
  1165.  
  1166.  
  1167.                            RIX files are colour files developed by ColoRIX
  1168.                            to use with their paint software.
  1169.  
  1170.           Syntax           -R
  1171.  
  1172.           Extension        .scx
  1173.                            .rix
  1174.  
  1175.           Creator          RIX Softworks, Inc.
  1176.  
  1177.           Used by          ColoRIX software
  1178.  
  1179.           Variations       Reads and writes Type 0 (8 bits per pixel) and
  1180.                            Type 4 (4 bits per pixel) images.
  1181.  
  1182.           Limitations      We would like to add support for Type 1 and Type
  1183.                            2 images but we haven't been able to find any;
  1184.                            if you have some please contact us.
  1185.  
  1186.           Comments         A type 0 file will be written if there are more
  1187.                            than 16 colours in the image; otherwise a type 4
  1188.                            file will be written.
  1189.  
  1190.           Examples         Convert the file test.gif to a RIX file:
  1191.  
  1192.                                 alchemy test.gif -R
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-18
  1219.  
  1220.  
  1221.  
  1222.           Silicon Graphics Image (SGI)                                   -n
  1223.  
  1224.  
  1225.                            Silicon Graphics Image files are used by Silicon
  1226.                            Graphics workstations.
  1227.  
  1228.           Syntax           -n compressionType
  1229.  
  1230.           Parameter        compressionType:
  1231.                                 0:Verbatim (uncompressed)
  1232.                                 1:RLE compressed
  1233.                            The default is 0 (Verbatim).
  1234.  
  1235.           Extension        .sgi
  1236.  
  1237.           Creator          Silicon Graphics, Inc.
  1238.  
  1239.           Used by          Silicon Graphics workstations.
  1240.  
  1241.           Variations       Reads and writes 1, 8 (gray-scale), and 24 bit
  1242.                            verbatim (uncompressed) and RLE files.
  1243.  
  1244.           Comments         Only gray-scale images may be 8 bit files.
  1245.                            Alchemy will automatically switch to 24 bit mode
  1246.                            when writing a colour image.
  1247.  
  1248.           Example          Convert the Sun raster file sun.im8 to a SGI
  1249.                            file called sgiout:
  1250.  
  1251.                                 alchemy -n sun.im8 sgiout -.
  1252.  
  1253.                            Do the same thing, but write out a RLE
  1254.                            compressed SGI file:
  1255.  
  1256.                                 alchemy -n1 sun.im8 sgiout -.
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-19
  1277.  
  1278.  
  1279.  
  1280.           SPOT Image                                                    --S
  1281.  
  1282.  
  1283.                            SPOT Image GIS data files are high-resolution
  1284.                            satellite images produced by SPOT Image
  1285.                            Corporation.
  1286.  
  1287.           Syntax           --S
  1288.  
  1289.           Extensions       .hdr (For image header information)
  1290.                            .bil (For pixel data)
  1291.                            .clr (For palette data [optional])
  1292.  
  1293.           Creator          SPOT Image Corp.
  1294.  
  1295.           Used by          SPOT Image Corp.
  1296.  
  1297.           Variations       8 bits per pixel
  1298.  
  1299.           Limitations      Only 1 band, GIS images are supported; if you
  1300.                            have any other type of SPOT GIS images we would
  1301.                            be interested in supporting them, please contact
  1302.                            us.
  1303.  
  1304.           Comments         SPOT Image images are actually three files.  You
  1305.                            specify the name of the .hdr file and Alchemy
  1306.                            automatically generates the name of the .bil and
  1307.                            .clr files.
  1308.  
  1309.                            If no palette file (.clr file) exists Alchemy
  1310.                            will assume the image is grayscale.
  1311.  
  1312.                            There may also be a statistics file with a .stx
  1313.                            extension, but Alchemy ignores this file.
  1314.  
  1315.                            When writing a SPOT file Alchemy will overwrite,
  1316.                            without warning, existing .bil and .clr files.
  1317.  
  1318.           Examples         Convert the Erdas file, phoenix.lan, to a SPOT
  1319.                            Image file:
  1320.  
  1321.                                 alchemy --S phoenix.lan
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-20
  1335.  
  1336.  
  1337.  
  1338.           Sun Raster                                                     -s
  1339.  
  1340.  
  1341.                            Sun Raster files are used by Sun Microsystems
  1342.                            workstations.
  1343.  
  1344.           Syntax           -s compressionType
  1345.  
  1346.           Parameter        compressionType:
  1347.                                 0:None
  1348.                                 1:Run length compression
  1349.                            The default is None.
  1350.  
  1351.           Extensions       .rast
  1352.                            .ras
  1353.                            .im
  1354.                            .im1
  1355.                            .im8
  1356.                            .im24
  1357.                            .im32
  1358.  
  1359.           Creator          Sun Microsystems, Inc.
  1360.  
  1361.           Used by          Sun workstations
  1362.  
  1363.           Variations       Reads 1, 8, 24, and 32 bit Standard, BGR, RGB,
  1364.                            and Byte Encoded (RLE) files.
  1365.  
  1366.                            Writes 1, 8, 24, and 32 bit Standard files, and
  1367.                            1 and 8 bit Byte Encoded (RLE) files.
  1368.  
  1369.           Limitations      For a short time a version of the PBM toolkit
  1370.                            wrote Sun Raster files which had the wrong RGB
  1371.                            order.  Unfortunately there seem to be many
  1372.                            images which were generated with this incorrect
  1373.                            RGB order.  Please be aware that Alchemy's Sun
  1374.                            Raster reading and writing capability has been
  1375.                            extensively tested and compared to various other
  1376.                            tools; the RGB order we use is correct.
  1377.  
  1378.           Comments         Sun Raster files are normally not compressed and
  1379.                            so take up lots of disk space.
  1380.  
  1381.                            There is no standard extension for Sun Raster
  1382.                            files; the extensions that Alchemy uses seem to
  1383.                            be the most common.
  1384.  
  1385.           Example          Convert the SGI file sgiout to a sun raster file
  1386.                            called sun.im8:
  1387.  
  1388.                                 alchemy -s sgiout sun.im8
  1389.  
  1390.  
  1391.  
  1392.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-21
  1393.  
  1394.  
  1395.  
  1396.           Windows Bitmap (BMP)                                           -w
  1397.  
  1398.  
  1399.                            Windows BMP files are used by Microsoft Windows.
  1400.  
  1401.           Syntax           -w compressionType
  1402.  
  1403.           Parameter        compressionType:
  1404.                                 0:None
  1405.                                 1:RLE
  1406.                                 10:Write an ICOn file
  1407.                            The default is none.
  1408.  
  1409.           Extension        .bmp
  1410.  
  1411.           Creator          Microsoft Corp.
  1412.  
  1413.           Used by          Microsoft Windows
  1414.  
  1415.           Variations       Reads 1, 4, 8, and 24 bit RGB (raw), RLE4, and
  1416.                            RLE8 files.
  1417.  
  1418.                            Writes 1, 4, 8, and 24 bit RGB (raw), RLE4, and
  1419.                            RLE8 files.
  1420.  
  1421.           Limitations      Several of the programs which claim to read and
  1422.                            write RLE files do not do so correctly; we do
  1423.                            not recommend writing RLE files unless you have
  1424.                            verified that they work with your intended
  1425.                            application.
  1426.  
  1427.           Comments         Microsoft supplied Windows utilities cannot read
  1428.                            nor write RLE4 or RLE8 files.
  1429.  
  1430.                            If you are converting an image to use as
  1431.                            wallpaper on a 16 colour display you will want
  1432.                            to match the palette of the output image to one
  1433.                            of the existing 16 colour BMP images supplied
  1434.                            with Windows (chess.bmp, for example).  If you
  1435.                            do not do this the wallpaper will not be loaded
  1436.                            correctly.  See the example section below.
  1437.  
  1438.                            If you are converting an image to use as
  1439.                            wallpaper on a 256 colour Windows 3.1 display
  1440.                            you will want to reserve the first 8 colours.
  1441.                            Use the -c 256 8 option to do this (see below
  1442.                            for an example).  This will force the first 8
  1443.                            colours of the palette to be the standard
  1444.                            Windows colours.
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-22
  1451.  
  1452.  
  1453.  
  1454.                            If you are writing a Windows icon (.ico) file
  1455.                            you must scale the image to a width and a height
  1456.                            of 16, 32, or 64 pixels (32 being the best
  1457.                            choice, since Windows displays all icons as
  1458.                            32x32).  Also, Windows seems to remap all icons
  1459.                            to the standard 16 colours, so the best results
  1460.                            can be obtained if you match the palette of your
  1461.                            icons to an existing icon (see the -f option).
  1462.                            If you don't have any other icons you can also
  1463.                            match to one of the 16 colour wallpaper files
  1464.                            supplied with Windows.
  1465.  
  1466.                            Alchemy can write an image with a palette
  1467.                            identity file as specified in the Microsoft
  1468.                            Multimedia Development Kit.  These images
  1469.                            provide for quicker bitmap loading when used
  1470.                            with the Multimedia Extensions.  A palette
  1471.                            identity file has the first and last 10 palette
  1472.                            entries reserved for 20 system defined colours.
  1473.                            Alchemy will write such an image if you specify
  1474.                            -c 246 10 as part of the command line.  Note
  1475.                            that ordinarily this would produce a file which
  1476.                            has 246 palette entries, but in this special
  1477.                            case the file will have 256 palette entries (20
  1478.                            fixed by the Windows specifications and 236
  1479.                            chosen by Alchemy).  Note that you can also
  1480.                            specify a number smaller than 246, but the
  1481.                            palette will always have 256 colours (since the
  1482.                            last 10 have to occupy positions 246 through
  1483.                            255)
  1484.  
  1485.           Related options  -c   Specify number of colours
  1486.                            -f   Match to existing palette
  1487.  
  1488.           Examples         Convert the image test.gif to a Windows BMP
  1489.                            file:
  1490.  
  1491.                                 alchemy test.gif -w
  1492.  
  1493.                            Convert the image test.gif to a 16 colour
  1494.                            Windows BMP file to be used as wallpaper (the
  1495.                            file chess.bmp is supplied with Windows 3.0
  1496.                            (substitute leaves.bmp when using Windows 3.1);
  1497.                            this example assumes that it is in the current
  1498.                            directory):
  1499.  
  1500.                                 alchemy test.gif -f chess.bmp -w
  1501.  
  1502.                            Convert the image test.gif to a 256 colour
  1503.                            Windows BMP file to be used as wallpaper with
  1504.                            Windows 3.1:
  1505.  
  1506.                                 alchemy test.gif -c256 8 -w
  1507.  
  1508.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-23
  1509.  
  1510.  
  1511.  
  1512.                            Convert the image test.gif to an icon file for
  1513.                            use with Windows 3.1:
  1514.  
  1515.                                 alchemy test.gif -Xb32 -Yb32 -w 10 -f
  1516.                                 leaves.bmp
  1517.  
  1518.                            Convert the image test.gif to an identity
  1519.                            palette BMP file:
  1520.  
  1521.                                 alchemy test.gif -w -c 246 10
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-24
  1567.  
  1568.  
  1569.  
  1570.           XPM                                                           --x
  1571.  
  1572.  
  1573.                            XPM files are used by the X Windowing System.
  1574.                            XPM files are C source code files which can be
  1575.                            read and written by various X utilities and are
  1576.                            designed to be included in C source code for use
  1577.                            as icons and other bit-mapped graphic images.
  1578.  
  1579.           Syntax           --x
  1580.  
  1581.           Extensions       .xpm
  1582.                            .pm
  1583.  
  1584.           Creator          MIT
  1585.  
  1586.           Used by          The X Windowing system
  1587.  
  1588.           Variations       8 bits per pixel
  1589.  
  1590.           Limitations      Because .xpm files are actually C source code
  1591.                            files there can be many variations of .xpm
  1592.                            files.  Since adding a C preprocessor to Alchemy
  1593.                            to handle all the theoretically allowable .xpm
  1594.                            files is impractical we have instead designed
  1595.                            Alchemy to interchange .xpm files with the PBM
  1596.                            utilities and the X supplied utilities, and to
  1597.                            read the sample .xpm files from IBM.  If you run
  1598.                            across any .xpm files which Alchemy can not read
  1599.                            please contact us.
  1600.  
  1601.                            Some XPM files contain colour names instead of
  1602.                            colour values for some of the colours.  The
  1603.                            conversion table of these names into values is
  1604.                            in the file rgb.txt.  Alchemy will look for this
  1605.                            table in the current directory and automatically
  1606.                            use it to convert XPM files if it is needed.
  1607.                            Therefore you may have to copy the rgb.txt file
  1608.                            to the current directory (its location is system
  1609.                            dependent; ask you system administrator if you
  1610.                            need help finding it).
  1611.  
  1612.           Comments         When writing an XPM file with less than 27
  1613.                            colours Alchemy writes 1 character XPM files,
  1614.                            otherwise Alchemy writes 2 character XPM files.
  1615.  
  1616.           Example          Convert the file picture.im32 to an XPM file
  1617.                            using high quality scaling and preserving the
  1618.                            aspect ratio:
  1619.  
  1620.                                 alchemy --x -Xb64 -+ picture.im32
  1621.  
  1622.  
  1623.  
  1624.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-25
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.           Colour and Palette Options
  1633.           -----------------------------------------------------------------
  1634.  
  1635.  
  1636.           Introduction     Since version 1.5 we have added two options to
  1637.                            the colour and palette section:
  1638.  
  1639.                                 Image Negation
  1640.                                 Gamma Correction
  1641.  
  1642.  
  1643.  
  1644.                            Also the options for these options has been
  1645.                            expanded:
  1646.  
  1647.                                 Dithering
  1648.                                 Spiffing
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-26
  1683.  
  1684.  
  1685.  
  1686.           Dither                                                         -d
  1687.  
  1688.  
  1689.           Purpose          Specifies the type of dithering to apply to the
  1690.                            image.
  1691.  
  1692.           Syntax           -d[s] ditherType [perturbation]
  1693.  
  1694.           Parameters       If the -d is immediately followed by an 's',
  1695.                            then a serpentine raster is used.
  1696.  
  1697.                            ditherType can be:
  1698.                                 0:None
  1699.                                 1:Floyd-Steinberg
  1700.                                 2:Stucki
  1701.                                 3:Jarvis, Judice, & Ninke
  1702.                                 4:Stevenson and Arce
  1703.                                 5:Sierra Lite
  1704.                                 20:Halftone (clustered dot)
  1705.                                 21:Bayer (dispersed dot)
  1706.                            The default is Floyd-Steinberg.
  1707.  
  1708.                            perturbation
  1709.                                 0 through 127
  1710.                            The default is 0.
  1711.  
  1712.           Comments         Dithering is used to reduce colour banding in an
  1713.                            image caused by the palette not having a perfect
  1714.                            match for every colour in the image.
  1715.  
  1716.                            Types 1 through 5 are all error-diffusion
  1717.                            dithers.  Types 1 and 5 are the fastest of the
  1718.                            diffusion dithers, and they usually look the
  1719.                            best on low resolution devices like CRTs.  Types
  1720.                            2, 3, and 4 all tend to cause an image to appear
  1721.                            more grainy on low resolution output devices
  1722.                            (such as CRTs).  However, they produce better
  1723.                            results than types 1 or 5 on high-resolution,
  1724.                            low colour output devices such as laser
  1725.                            printers.
  1726.  
  1727.                            Type 20 is a digital halftone; this will produce
  1728.                            the most accurate grays on a laser printer, but
  1729.                            the image won't be as sharp as one produced by
  1730.                            the error-diffusion dithers.  Type 21 is a
  1731.                            dispersed dot ordered dither; it's only
  1732.                            advantage over the error-diffusion algorithms is
  1733.                            speed.
  1734.  
  1735.                            The -d option only has an effect if the number
  1736.                            of colours is being reduced or the image is
  1737.                            being re-mapped to a new palette.
  1738.  
  1739.  
  1740.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-27
  1741.  
  1742.  
  1743.  
  1744.                            Specifying a perturbation adds noise to the
  1745.                            image, which can help break up visible patterns
  1746.                            introduced by dithering.  The parameter
  1747.                            specifies the magnitude of the noise.
  1748.                            Perturbation has no effect on dither types 20
  1749.                            and 21.
  1750.  
  1751.                            Using a serpentine raster can also help to
  1752.                            reduce visible patterns introduced by dithering.
  1753.                            Using a serpentine raster has no effect on
  1754.                            dither types 20 and 21.
  1755.  
  1756.           Examples         Convert the 256 colour file image.gif to a 16
  1757.                            colour PCX file using a uniform palette and no
  1758.                            dithering:
  1759.  
  1760.                                 alchemy image.gif -p -c16 -d0 -u
  1761.  
  1762.                            Convert the true colour image sample.jpg into a
  1763.                            256 colour GIF file called sample.gif, using
  1764.                            Stucki dithering:
  1765.  
  1766.                                 alchemy -g -d2 sample.jpg
  1767.  
  1768.                            Convert the 256 colour image sample.gif into a
  1769.                            one bit black and white PCL file called
  1770.                            sample.pcl, using Jarvis, Judice, and Ninke
  1771.                            dithering, a serpentine raster, and a little
  1772.                            noise:
  1773.  
  1774.                                 alchemy -P -b -c2 -ds3 20 sample.gif
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-28
  1799.  
  1800.  
  1801.  
  1802.           Gamma correction                                               -G
  1803.  
  1804.  
  1805.           Purpose          Specify the gamma of an input, output, or
  1806.                            palette file and/or perform gamma correction.
  1807.  
  1808.           Syntax           -G gammaType gammaValue
  1809.  
  1810.           Parameters       gammaType:
  1811.                                 i:Specify input gamma
  1812.                                 o:Specify output gamma
  1813.                                 p:Specify gamma of palette
  1814.  
  1815.                            gammaValue:
  1816.                                 0.0 to 4.0
  1817.  
  1818.           Comments         To perform gamma correction, Alchemy needs to
  1819.                            know both the input and output gamma.  For some
  1820.                            file formats the gamma is known; if you're
  1821.                            reading a file with known gamma, such as JPEG,
  1822.                            PICT, PCPAINT, or a Targa file with the gamma
  1823.                            field, you don't need to specify the input
  1824.                            gamma.  Likewise, if you're writing a file which
  1825.                            has a fixed gamma you don't need to specify an
  1826.                            output gamma.  Even if reading or writing a file
  1827.                            format which has a known gamma you may override
  1828.                            it by using the -Gi or -Go option.
  1829.  
  1830.                            However, even if both input and output gamma are
  1831.                            known based on the input file and the output
  1832.                            format, you must still enable gamma correction
  1833.                            for any correction to take place; you can do
  1834.                            this with just '-G' (if you had specified input,
  1835.                            output, or palette gamma, this would be
  1836.                            implied).  This is because there are quite a few
  1837.                            images around that have specified or implied
  1838.                            gammas that are wrong, which could cause Alchemy
  1839.                            to make matters worse instead of better.
  1840.  
  1841.                            Typical values for gamma are 1.0 for images from
  1842.                            Macintoshes and 2.2 for images from PCs.
  1843.  
  1844.           Examples         To convert the Mac PICT file test.pic, which has
  1845.                            a gamma of 1.0, to a PCX file for use on a PC
  1846.                            (which should have a gamma of 2.2), use:
  1847.  
  1848.                                 alchemy -p -Gi1.0 -Go2.2 test.pic
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-29
  1857.  
  1858.  
  1859.  
  1860.                            The input gamma could have been omitted, as PICT
  1861.                            files have an implied gamma of 1.0, but it's
  1862.                            best to include it to reduce confusion.
  1863.  
  1864.                            To convert the file image.tga, which has a gamma
  1865.                            of 2.2, to a GIF file for use on a Mac, matching
  1866.                            the palette test.pal which was created with a
  1867.                            gamma of 1.5:
  1868.  
  1869.                                 alchemy image.tga -g -Gi2.2 -Go1.0 -Gp1.5 -
  1870.                                 ftest.pal
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-30
  1915.  
  1916.  
  1917.  
  1918.           Negate                                                         -N
  1919.  
  1920.  
  1921.           Purpose          Changes the image to a negative.
  1922.  
  1923.           Syntax           -N
  1924.  
  1925.           Comments         This is equivalent to a photographic negative.
  1926.                            When used on black and white images black is
  1927.                            changed to white and white is changed to black.
  1928.                            On colour images each of the Red, Green, and
  1929.                            Blue channels are inverted separately (so that
  1930.                            bright blue will become bright yellow).
  1931.  
  1932.           Examples         Negate the file sample.gif, generating a GIF
  1933.                            file called negative.gif:
  1934.  
  1935.                                 alchemy sample.gif -N -g negative
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-31
  1973.  
  1974.  
  1975.  
  1976.           Spiff                                                          -S
  1977.  
  1978.  
  1979.           Purpose          Enhance the image contrast by stretching the
  1980.                            pixel colour values to the full 0 to 255 range.
  1981.  
  1982.           Syntax           -S spiffType
  1983.  
  1984.           Parameter        spiffType:
  1985.                                 a:histogram stretching
  1986.                                 b:histogram linearization
  1987.                            The default is histogram stretching.
  1988.  
  1989.           Comments         This command can be used if the image you are
  1990.                            converting is shifted in brightness or squished
  1991.                            in contrast.  This can happen if you scan or
  1992.                            digitize a very dark or very bright image.
  1993.  
  1994.                            The default type, histogram stretching, simply
  1995.                            insures that the image has pixels which are
  1996.                            distributed over the entire output range (0 to
  1997.                            255).
  1998.  
  1999.                            Histogram linearization insures that the
  2000.                            distribution of pixels over the output range is
  2001.                            linear.
  2002.  
  2003.                            Histogram linearization can produce
  2004.                            significantly better results than histogram
  2005.                            stretching for some images.  Generally you will
  2006.                            want to try both types to see which gives better
  2007.                            results.
  2008.  
  2009.           Limitations      The -S option cannot be used at the same time as
  2010.                            the -b option when converting from a true colour
  2011.                            image.  A work around is to do the operation in
  2012.                            two steps, converting it to black and white
  2013.                            first and then spiffing the resulting image.
  2014.  
  2015.                            Using the spiff option at the same time as the
  2016.                            match palette, -f, or false colour, -F, options
  2017.                            is not allowed.  This is because the spiff
  2018.                            option would be performed before the palette is
  2019.                            changed, which would nullify the effects.  A
  2020.                            work around is to do the matching or false
  2021.                            colouring first, and then spiff the resultant
  2022.                            image.
  2023.  
  2024.           Related options  -b   Black and White
  2025.                            -f   Match palette
  2026.                            -F   False colour image
  2027.  
  2028.  
  2029.  
  2030.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-32
  2031.  
  2032.  
  2033.  
  2034.           Example          Convert the file gloomy.pcx into a PCX file
  2035.                            called better.pcx:
  2036.  
  2037.                                 alchemy gloomy.pcx -S -p better.pcx
  2038.  
  2039.                            Do the same thing using histogram linearization
  2040.                            instead of histogram stretching:
  2041.  
  2042.                                 alchemy gloomy.pcx -Sb -p better.pcx
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-33
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.           Viewing Options (MS-DOS Only)
  2100.           -----------------------------------------------------------------
  2101.  
  2102.  
  2103.           Display hardware Image Alchemy v1.6 supports VESA compatible and
  2104.                            S3 equipped SVGA boards for 15 bit viewing.  In
  2105.                            addition, a scaled 15 bit viewing option has
  2106.                            been added.
  2107.  
  2108.                            There are also two new environment variable
  2109.                            options which affect viewing.  One allows the
  2110.                            disabling of checking for the 8514/A board
  2111.                            (which causes problems with some network adapter
  2112.                            boards) and the other allows you to specify the
  2113.                            maximum resolution that your monitor is capable
  2114.                            of when viewing with a VESA compatible VGA
  2115.                            board; see the section on installing Image
  2116.                            Alchemy earlier in this addendum.
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-34
  2147.  
  2148.  
  2149.  
  2150.           View Image in 15 Bit Mode                                     --v
  2151.  
  2152.  
  2153.           Purpose          View file using 15 bits/pixel mode.  This allows
  2154.                            true colour images to be viewed without
  2155.                            dithering to a uniform palette.
  2156.  
  2157.           Syntax           --v horizontalResolution
  2158.  
  2159.           Parameter        horizontalResolution
  2160.                                 640:Use 640x480 mode
  2161.                                 800:Use 800x600 mode
  2162.                                 1024:Use 1024x768 mode
  2163.                                 1280:Use 1280x1024 mode
  2164.  
  2165.           Comments         Requires either a Tseng 4000 equipped SVGA, an
  2166.                            S3 equipped SVGA board, or a VESA compatible
  2167.                            SVGA board with a Sierra DAC and 1 Megabyte of
  2168.                            memory on the SVGA board.
  2169.  
  2170.                            24 bit images will be dithered to 15 bit when
  2171.                            using this option.  You can turn off dithering
  2172.                            (speeding up the display and slightly reducing
  2173.                            the image quality) by using the -d option.
  2174.  
  2175.           Related options  --V  View scaled image in 15 bit mode
  2176.                            -d   Specify dither type
  2177.  
  2178.           Example          View madonna.tga:
  2179.  
  2180.                                 alchemy madonna.tga --v
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-35
  2205.  
  2206.  
  2207.  
  2208.           View Scaled Image in 15 Bit Mode                              --V
  2209.  
  2210.  
  2211.           Purpose          View image in 15 bit mode while scaling image to
  2212.                            fit on monitor and correcting aspect ratio.
  2213.  
  2214.           Syntax           --V horizontalResolution
  2215.  
  2216.           Parameter        horizontalResolution
  2217.                                 640:Use 640x480 mode
  2218.                                 800:Use 800x600 mode
  2219.                                 1024:Use 1024x768 mode
  2220.                                 1280:Use 1280x1024 mode
  2221.  
  2222.           Comments         Requires either a Tseng 4000 equipped SVGA, an
  2223.                            S3 equipped SVGA board, or a VESA compatible
  2224.                            SVGA board with a Sierra DAC and 1 Megabyte of
  2225.                            memory on the SVGA board.
  2226.  
  2227.                            This command will scale the image and correct
  2228.                            the aspect ratio of the image by removing rows
  2229.                            and/or columns from the image.
  2230.  
  2231.                            Note that this option can also be useful for
  2232.                            displaying images which are not larger than the
  2233.                            screen but which have an aspect ratio different
  2234.                            than the display.
  2235.  
  2236.           Limitations      The same limitations as for scaled 8 bit viewing
  2237.                            apply (see page 7-7 in the User's Manual).
  2238.  
  2239.           Related options  -D   Specify image resolution
  2240.                            --v  View image in 15 bit mode
  2241.  
  2242.           Example          View sample.jpg:
  2243.  
  2244.                                 alchemy sample.jpg --V
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-36
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.           Answers to Frequently Asked Questions
  2271.           -----------------------------------------------------------------
  2272.  
  2273.  
  2274.  
  2275.                   Question How do I get a copy of the current draft JPEG
  2276.                            standard?
  2277.  
  2278.                     Answer The JPEG standard is a ISO/IEC standard
  2279.                            currently in Committee Draft form.
  2280.  
  2281.                            Contact your local ISO/IEC office to get a copy.
  2282.                            The reference numbers are ISO/IEC JTC 1 and /SC
  2283.                            2 N2215; the document number is ISO/IEC CD
  2284.                            10918-1.
  2285.  
  2286.                            In the United States you can contact ANSI at:
  2287.                               ANSI
  2288.                               11 West 42nd St.
  2289.                               New York, NY  10036
  2290.                               (212) 642-4900
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-37
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.           Version History
  2329.           -----------------------------------------------------------------
  2330.  
  2331.  
  2332.           Version 1.6      Released for MS-DOS, 80386 Protected Mode, Sun
  2333.                05/92       SPARC, Interactive UNIX, SCO UNIX, IBM RS/6000,
  2334.                            HP 9000/7xx & 8xx, and Silicon Graphics IRIS.
  2335.  
  2336.                    Format  Added AVHRR support.
  2337.                            Added PDS support.
  2338.                            Added RIX support.
  2339.                            Added SPOT Image support.
  2340.                            Added GOES support.
  2341.                            Added CALS support.
  2342.                            Added Alpha Microsystems BMP support.
  2343.                            Added Dr. Halo CUT support.
  2344.                            Added First Publisher ART support.
  2345.                            Added PictureMaker support.
  2346.                            Added XPM support.
  2347.                            Added IBM Picture Maker support.
  2348.  
  2349.                            Disabled LZW Compression in TIFF pending
  2350.                            resolution of patent issues (and changed default
  2351.                            TIFF compression to PackBits).
  2352.                            Added support for reading tiled TIFF images.
  2353.                            Added support for reading JTIFF images.
  2354.                            Added support for several additional types of
  2355.                            incorrect TIFF files.
  2356.                            Added support for reading type 1, mapped PICT
  2357.                            files.
  2358.                            Added support for reading and writing multi-bit
  2359.                            grayscale and colour GEM files.
  2360.                            Added support for reading 4 bit XWD files.
  2361.                            Added support for an additional type of
  2362.                            incorrect Targa file.
  2363.                            Made PCL reading more robust (including adding
  2364.                            support for landscape files).
  2365.                            Added support for reading old format BMP files.
  2366.                            Added support for Gamma information in Utah RLE
  2367.                            files.
  2368.                            Added default palettes to WPG reading.
  2369.                            Added support for reading 5-5-5 PICT files.
  2370.                            Added compression option to Sun Raster and SGI
  2371.                            files.
  2372.                            Added compression to writing Utah RLE, GEM, and
  2373.                            WPG files.
  2374.                            Added support for writing BMP Icon files and BMP
  2375.                            palette identity files.
  2376.  
  2377.  
  2378.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-38
  2379.  
  2380.  
  2381.  
  2382.                   Display  Added support for 15 bit VESA compatible SVGA
  2383.                  (MS-DOS)  boards.
  2384.                            Added support for S3 equipped 15 bit SVGA
  2385.                            boards.
  2386.                            Added scaled 15 bit view option.
  2387.                            Added environment variables to indicate monitor
  2388.                            resolution.
  2389.  
  2390.                      Misc  Decreased memory usage for MS-DOS version
  2391.                            (allowing the conversion of larger images).
  2392.                            Added 5 new dithering types.
  2393.                            Added histogram equalization option to spiff.
  2394.                            Added negative flag.
  2395.                            Added gamma correction.
  2396.  
  2397.                Bugs fixed  Writing to directories not on the current disk
  2398.                            (MS-DOS).
  2399.                            Reading certain 1 bit PCX files.
  2400.                            Reading certain PICT files.
  2401.                            Checking for Targa files.
  2402.                            Viewing on certain VESA boards (MS-DOS).
  2403.                            Reading certain 8 bit ILBM files.
  2404.                            Scaled viewing of very skinny images (MS-DOS).
  2405.                            Histogram equalization (non MS-DOS).
  2406.                            Writing WPG files.
  2407.                            Writing 1 bit PBM files.
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.    Image Alchemy v1.6   Copyright (c) 1992 Handmade Software Inc.  Addendum-39